home *** CD-ROM | disk | FTP | other *** search
/ Joint Education Initiative / Joint Education Initiative.iso / dos / user_doc / pcmips.man < prev    next >
Text File  |  1990-04-19  |  57KB  |  1,585 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                               Draft version of
  20.  
  21.                             PC-MIPS User Manual
  22.  
  23.                                as of 04/19/90
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                               PC-MIPS User Manual
  70.  
  71.  
  72.  
  73.                           Table of Contents
  74.  
  75.        PC-MIPS Overview   . . . . . . . . . . . . . . . . . . .    1
  76.        Installing PC-MIPS   . . . . . . . . . . . . . . . . . .    5
  77.        User Interface   . . . . . . . . . . . . . . . . . . . .    5
  78.        Image Data Structure . . . . . . . . . . . . . . . . . .    6
  79.        User Input   . . . . . . . . . . . . . . . . . . . . . .    7
  80.        PC-MIPS Programs
  81.        CMBIMG   . . . . . . . . . . . . . . . . . . . . . . . .    8
  82.        DERIV    . . . . . . . . . . . . . . . . . . . . . . . .    8
  83.        EDGENH   . . . . . . . . . . . . . . . . . . . . . . . .    9
  84.        EXT_ROI  . . . . . . . . . . . . . . . . . . . . . . . .   10
  85.        FLT8B    . . . . . . . . . . . . . . . . . . . . . . . .    *
  86.        IMDISP   . . . . . . . . . . . . . . . . . . . . . . . .   10
  87.        LIST     . . . . . . . . . . . . . . . . . . . . . . . .   10
  88.        MAPIMG   . . . . . . . . . . . . . . . . . . . . . . . .   11
  89.        MAPLN1   . . . . . . . . . . . . . . . . . . . . . . . .   12
  90.        MDGRAD   . . . . . . . . . . . . . . . . . . . . . . . .   13
  91.        MEDIAN   . . . . . . . . . . . . . . . . . . . . . . . .   13
  92.        MIXBDS   . . . . . . . . . . . . . . . . . . . . . . . .    *
  93.        NUVU     . . . . . . . . . . . . . . . . . . . . . . . .    *
  94.        OVRLAY   . . . . . . . . . . . . . . . . . . . . . . . .   14
  95.        PCA      . . . . . . . . . . . . . . . . . . . . . . . .    *
  96.        PICSTR   . . . . . . . . . . . . . . . . . . . . . . . .    *
  97.        RADARS   . . . . . . . . . . . . . . . . . . . . . . . .    *
  98.        RATIO    . . . . . . . . . . . . . . . . . . . . . . . .   16
  99.        ROI      . . . . . . . . . . . . . . . . . . . . . . . .   17
  100.        ROTATE   . . . . . . . . . . . . . . . . . . . . . . . .   17
  101.        SALTP    . . . . . . . . . . . . . . . . . . . . . . . .   18
  102.        SCALE    . . . . . . . . . . . . . . . . . . . . . . . .    *
  103.        SHAD2    . . . . . . . . . . . . . . . . . . . . . . . .   19
  104.        SHADRF   . . . . . . . . . . . . . . . . . . . . . . . .    *
  105.        STATS    . . . . . . . . . . . . . . . . . . . . . . . .    *
  106.        STEEP    . . . . . . . . . . . . . . . . . . . . . . . .    *
  107.        STENCL   . . . . . . . . . . . . . . . . . . . . . . . .    *
  108.        STRTCH   . . . . . . . . . . . . . . . . . . . . . . . .   20
  109.        SUBIMG   . . . . . . . . . . . . . . . . . . . . . . . .   21
  110.        SUN      . . . . . . . . . . . . . . . . . . . . . . . .    *
  111.        WTCMBO   . . . . . . . . . . . . . . . . . . . . . . . .   21
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.        * - program write-up, as yet, not completed.
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.                               PC-MIPS User Manual
  136.  
  137.  
  138.  
  139.                            PC-MIPS Overview
  140.  
  141.             Historically, the processing and analysis of GLORIA side-
  142.        scan sonar data within the U.S. Geological Survey has been done
  143.        on DEC mini-computers using the MIPS software system.  Due to the
  144.        volume of work generated by the EEZ sea-floor mapping program,
  145.        these systems have not been readily available to a large group of
  146.        marine scientists who would like to perform investigations that
  147.        require image analysis capabilities.  At the same time, the
  148.        availability and use of very powerful PCs has significantly
  149.        increased. Recently, the processed GLORIA imagery has been made
  150.        available on Compact Disks (CDROM) which can be accessed by PCs.
  151.        These factors make a PC-based MIPS-like system highly desirable.
  152.        The PC-MIPS system is an attempt to satisfy this need.
  153.  
  154.            PC-MIPS is an integrated collection of programs which have
  155.        been adapted to a PC environment.  Most of these programs have
  156.        been selected from the MIPS software system developed at the USGS
  157.        Image Processing Facility in Flagstaff, Arizona.  While internal
  158.        program and data structures have been extensively modified, an
  159.        attempt has been made to preserve the basic appearance to the
  160.        experienced MIPS user.
  161.  
  162.             PC-MIPS was developed using MS-DOS version 3.31 for the
  163.        Compaq Deskpro.  Microsoft's Fortran version 5.0 was chosen as
  164.        the development language since about half of the MIPS system was
  165.        written in Fortran (the other half being in the MAC assembler
  166.        language).
  167.  
  168.             The selection of a display mechanism has largely been based
  169.        on the availability of existing PC-based software.  During the
  170.        early stages of the GLORIA CD-ROM project, an image display
  171.        program (IMDISP) developed by NASA at the Jet Propulsion Lab was
  172.        evaluated and found to be excellent for displaying GLORIA images
  173.        on a PC.  IMDISP supports all the major graphics standards (i.e.,
  174.        CGA, EGA, VGA, and PGA).  It provides an extensive set of
  175.        commands and utilizes a very simple but robust set of file
  176.        structures.
  177.  
  178.             The hardware utilized for the development of PC-MIPS is a
  179.        Compaq 386/20 Model 130 equipped with 2Mb ram, the 80387/20 math
  180.        coprocessor and a VGA color monitor.  This configuration provides
  181.        processing speeds which average 26Kb per second.  In other words,
  182.        if you process an input image 1Mb in size and create a resultant
  183.        output image of the same size, the processing time will usually
  184.        be under 1.5 minutes.
  185.  
  186.             Standard VGA provides a display of 16 colors and/or grey
  187.        levels with a resolution of 640 by 480 pixels.  A display of 64
  188.        grey levels can be achieved using the Orchid ProDesigner PLUS VGA
  189.        card with 512K on-board memory.
  190.  
  191.             The hardware configuration which was used for development is
  192.        recommended for use; however, PC-MIPS will run under MS-DOS on
  193.  
  194.  
  195.                                        1
  196.  
  197.  
  198.  
  199.  
  200.  
  201.                               PC-MIPS User Manual
  202.  
  203.  
  204.  
  205.        any generic PC/AT class machine with VGA graphics, and a hard
  206.        disk.    The  software  itself  occupies  approximately  2.6Mb.
  207.        Realistically, a hard disk of at least 40Mb should be used.
  208.  
  209.  
  210.             Following is a list of the programs currently available:
  211.  
  212.        CMBIMG     Combines from 2 - 4 input images to create a composite
  213.                   output image which can be displayed via IMDISP.
  214.  
  215.        DERIV      Generates the first differences in the horizontal,
  216.                   vertical, or diagonal direction.
  217.  
  218.        EDGENH     Uses a Laplacian transform to provide edge enhancement
  219.                   capabilities.
  220.  
  221.        EXT_ROI    Used to extract an irregularly shaped sub-image
  222.                   (defined in POLYGON.DAT) from up to 7 input images.
  223.  
  224.        FLT8B      Boxcar spatial filtering (powerful workhorse; high and
  225.                   low pass filtering; surface generation; interpolation
  226.                   for gaps; edge enhancement; etc.).
  227.  
  228.        IMDISP     JPL's image display program.  Currently 18 commands
  229.                   are implemented.  Among them are Profile, Stretch,
  230.                   Palette, Histogram, Browse, and Display with or
  231.                   without sub-sampling and/or zoom. Text may, also, be
  232.                   positioned on the display.
  233.  
  234.        LIST       Generates a printout (LIST.PRT) of DN values for an
  235.                   image. Sub-image areas may be specified.
  236.  
  237.        MAPIMG     Performs a user-specified mapping of 1 to 7 input
  238.                   files.  An extremely robust program that generates an
  239.                   output image which is the result of a user-specified
  240.                   functional mapping applied to the input files.
  241.  
  242.        MAPLN1     Enhances linear features using a semi-linear line
  243.                   detecting/mapping technique (useful for regular image
  244.                   data as well as Topo, Gravity, etc.).
  245.  
  246.        MDGRAD     Modified gradient method that instead of multiplying
  247.                   the constants together adds them because of the
  248.                   possibility of one of them being ZERO (linear feature
  249.                   enhancement/mapping technique; used on image and
  250.                   surface data such as TOPO).
  251.  
  252.        MEDIAN     Applies a 3 by 3 median (middle value) filter.  Will
  253.                   help remove high frequency noise.  MEDIAN is
  254.                   particularly suitable for data that has a skewed
  255.                   distribution.  However, the value obtained for the
  256.                   median may not be representative if the individual
  257.                   items do not tend to cluster at the center of the
  258.                   distribution.
  259.  
  260.  
  261.                                        2
  262.  
  263.  
  264.  
  265.  
  266.  
  267.                               PC-MIPS User Manual
  268.  
  269.  
  270.  
  271.  
  272.        MIXBDS     Will generate three output bands from the TM six bands
  273.                   by selecting the user-specified three optimum bands
  274.                   for each of vegetation, soils, and water. For example,
  275.                   vegetation pixels might have TM bands 2,4, and 5;
  276.                   soils pixels might have TM bands 1,4, and 5; while
  277.                   water pixels might have TM bands 1,2, and 3.  This
  278.                   will allow the three output bands to be used for
  279.                   either color compositing or digital processing so that
  280.                   these three 'new' bands have the best combination for
  281.                   these three major cover types.
  282.  
  283.        NUVU       Creates oblique views of image data using a
  284.                   Topographic height file and/or image file.  If only
  285.                   the image file is used, the DN value is interpreted as
  286.                   height.
  287.  
  288.        OVRLAY     Takes from 2 to 6 input files/images and generates one
  289.                   output file/image that indicates which of the input
  290.                   files have data in user specified ranges for the input
  291.                   files being used.
  292.  
  293.        PCA        Generates the linear combinations for Principal
  294.                   Component Analysis of two to seven files (the output
  295.                   of STATS may be used as input coefficients).
  296.  
  297.        PICSTR     This program allows the user to let the machine pick
  298.                   good stretch pairs for an image based on either min/
  299.                   max parameters or by giving a min/max percent of the
  300.                   image.  Values outside these ranges are ignored when
  301.                   trying to pick DN values.
  302.  
  303.        RADARS     Uses digital elevation data as input (dma, dem, etc.)
  304.                   and outputs the elevation data with it's geometry
  305.                   converted to slant range mode.  The user specifies the
  306.                   near range (nr) depression angle (used to determine nr
  307.                   to nadir distance) and the imaging system's height and
  308.                   pixel resolution.  It assumes the radar scan direction
  309.                   is in the horizontal direction (i.e., the imaging
  310.                   system is on the left or right side of the image).
  311.  
  312.        RATIO      Generates up to three output images that are the
  313.                   result of dividing the up to four input images by each
  314.                   other.
  315.  
  316.        ROI        Used to define and extract an irregularly shaped sub-
  317.                   image from up to 7 input images.  Requires VGA and
  318.                   serial MS compatible mouse.
  319.  
  320.        ROTATE     Rotates an image 90 degrees in the clockwise or
  321.                   counter-clockwise direction.
  322.  
  323.        SALTP      Does bit error or random noise removal (Salt and
  324.                   Pepper).
  325.  
  326.  
  327.                                        3
  328.  
  329.  
  330.  
  331.  
  332.  
  333.                               PC-MIPS User Manual
  334.  
  335.  
  336.  
  337.  
  338.        SCALE      Changes the scale of an image in the line direction,
  339.                   sample direction, or both.
  340.  
  341.        SHAD2      Does automatic shading correction on Sonar, Radar, or
  342.                   any other file.
  343.  
  344.        SHADRF     Computes reflectance for any sun elevation and one of
  345.                   four sun directions using Lommel-Seeliger Law.
  346.  
  347.        STATS      Computes the Mean, Standard Deviation, Variance,
  348.                   Covariance, and Correlation Coefficients between two
  349.                   to seven images. It will also create the eigen vector
  350.                   matrix that is required as input to PCA.
  351.  
  352.        STEEP      Uses surface data as input (dem, dma, gravity, etc.)
  353.                   and generates a thematic map (0's or 255's) of ridges
  354.                   or drainage patterns (i.e., maps linear features).
  355.  
  356.        STENCL     Uses two input files.  The first file is 'stenciled'
  357.                   based on data of second file.  Generates one output
  358.                   file.
  359.  
  360.        STRTCH     Performs contrast stretching on an image using up to
  361.                   10 user-specified stretch intervals.
  362.  
  363.        SUBIMG     Allows the extraction and/or "flipping" (i.e.,
  364.                   reversing) of sub-images in the line and/or sample
  365.                   direction.
  366.  
  367.        SUN        Computes reflectance given any sun elevation and
  368.                   direction.
  369.  
  370.        WTCMBO     Generates the weighted sum of 1 to 4 input files.  The
  371.                   weighting coefficients are specified by the user and
  372.                   must be real numbers.  The DN values for the output
  373.                   file are computed as follows:
  374.                   OUT = C1*INPUT1 + C2*INPUT2 + C3*INPUT3 + C4*INPUT4 +
  375.                         C5
  376.                   Where C1, C2, C3, C4, and C5 are user-specified
  377.                   constants.
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                                        4
  394.  
  395.  
  396.  
  397.  
  398.  
  399.                               PC-MIPS User Manual
  400.  
  401.  
  402.  
  403.                              Installing PC-MIPS
  404.  
  405.  
  406.             PC-MIPS can be installed on any hard disk drive (e.g., C:,
  407.        D:, E:,,,etc.).  Once a drive is selected, the installer should
  408.        create a root-level directory named \MIPS.  Next, the two sub-
  409.        directories \MIPS\BIN and \MIPS\AUX_FILE must be created.  These
  410.        directories are created using the DOS command MKDIR or MD.  The
  411.        executable programs of PC-MIPS are stored in the \MIPS\BIN
  412.        directory.    The  \MIPS\AUX_FILE  directory  contains  various
  413.        auxiliary files used by PC-MIPS programs.
  414.  
  415.             Two 1.2Mb floppy disks contain three programs which are used
  416.        to load the \MIPS sub-directories.  These programs are named
  417.        AUX_LOAD.EXE, BIN_LD1.EXE, and BIN_LD2.EXE (they were created
  418.        using the program PKSFX from PKWARE INC., 7032 Ardara Ave.,
  419.        Glendale, WI 53209).  The installer should first load the
  420.        AUX_FILE  sub-directory  by  typing  A:AUX_LOAD  \MIPS\AUX_FILE.
  421.        Next,  the  BIN  sub-directory  is  partially  loaded  by  typing
  422.        A:BIN_LD1 \MIPS\BIN.  The installation is completed by inserting
  423.        the second floppy disk and typing A:BIN_LD2 \MIPS\BIN.  These
  424.        steps can be performed automatically by executing the INSTALL.BAT
  425.        files found on each floppy disk.  They assume installation on
  426.        hard disk drive C:.
  427.  
  428.             Once the two floppy disks have been loaded, the AUTOEXEC.BAT
  429.        file should be changed so that the display program IMDISP knows
  430.        what display device is being used.  This is done by setting the
  431.        environmental variable IMDISP.  For instance, if the hardware has
  432.        standard VGA capabilities, the line SET IMDISP=VGA must be added
  433.        to the AUTOEXEC.BAT file.  A complete list of devices supported
  434.        by IMDISP can be found in the file IMDISP.DOC.
  435.  
  436.             PC-MIPS can now be executed by typing \MIPS\BIN\PC_MIPS.  If
  437.        \MIPS\BIN is added to the DOS PATH command in the AUTOEXEC.BAT
  438.        file, the system can be run by simply typing PC_MIPS.
  439.  
  440.  
  441.                             User Interface
  442.  
  443.             Individual PC-MIPS programs can be executed directly or via
  444.        a menu-driven interface.  A menu-driven interface presents the
  445.        user with a list of the PC-MIPS programs available for use and
  446.        provides a mechanism for selecting and executing individual
  447.        entries.  Individual programs in the list may be selected by name
  448.        or number.  PC_MIPS, also, provides a gateway which allows
  449.        execution of DOS commands without exiting the system.  This
  450.        gateway is entered by typing DOS at the user prompt.  After the
  451.        gateway is entered, the user returns to the menu by typing
  452.        PC_MIPS in response to the DOS> prompt.
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.                                        5
  460.  
  461.  
  462.  
  463.  
  464.  
  465.                               PC-MIPS User Manual
  466.  
  467.  
  468.  
  469.                             Image Data Structure
  470.  
  471.             The PC-MIPS image data structure is a subset of JPL's PDS
  472.        data structure (see IMDISP.DOC).  This subset has the following
  473.        restrictions:
  474.             1. Only 8 bit data is supported.
  475.             2. The image definition must be contained in a separate
  476.                image label file.
  477.             3. Image header records are not supported.
  478.             4. Line prefix and suffix bytes are not supported.
  479.  
  480.             A PC-MIPS image is composed of two files.  The first is an
  481.        image label file and the second is an image data file.
  482.  
  483.             Image label files contain information describing the image
  484.        such as the number of lines, the number of samples, and the
  485.        location (path name) of the image data file.  Records of the
  486.        image label file contain keywords and values.  The mandatory
  487.        keywords are FILE_TYPE, IMAGE_LINES, LINE_SAMPLES, IMAGE_POINTER,
  488.        and END.  These are described as follows:
  489.  
  490.        FILE_TYPE     - Must have the value IMAGE.
  491.        IMAGE_LINES   - Gives the number of lines (i.e., rows) in the
  492.                        image.
  493.        LINE_SAMPLES  - Gives the number of samples (i.e., columns) per
  494.                        line.
  495.        IMAGE_POINTER - Gives the path name of the image data file.
  496.        END           - Must be the last record of a label file.
  497.  
  498.        If the PDS keyword LINE_PREFIX_BYTES is given, its value will be
  499.        added to the LINE_SAMPLES value.  The following image label file
  500.        named SAMPLE defines an image of 460 lines and 407 samples:
  501.  
  502.        FILE_TYPE    = IMAGE
  503.        IMAGE_LINES  =   460
  504.        LINE_SAMPLES =   407
  505.        IMAGE_POINTER= \images\sample.img
  506.        END
  507.  
  508.             The image data file is binary (i.e., non-printable) and
  509.        contains the DN values which comprise the image.  This file MUST
  510.        be IMAGE_LINES times LINE_SAMPLES bytes in size.  It is simply a
  511.        contiguous sequence of bytes (i.e., DN values) which represent
  512.        the image stored in row (i.e., line) major order.
  513.  
  514.             While running PC-MIPS programs, the user refers to an image
  515.        using the image label file name.  THIS FILE NAME SHOULD NOT HAVE
  516.        A DOS EXTENSION (i.e., not contain a period).  A PC-MIPS output
  517.        image will be composed of the user-specified image label file
  518.        name and an image data file whose name is the same but has .IMG
  519.        as a DOS extension.
  520.  
  521.  
  522.  
  523.  
  524.  
  525.                                        6
  526.  
  527.  
  528.  
  529.  
  530.  
  531.                               PC-MIPS User Manual
  532.  
  533.  
  534.  
  535.                                  User Input
  536.  
  537.             PC-MIPS has two types of user input.  The first type is file
  538.        names (input and/or output).  The second type is parameters that
  539.        control the computation.
  540.  
  541.             File names are entered by the user at the FILES> prompt.
  542.        The user responds by entering a list of output names, followed by
  543.        an equal sign, followed by a list of input names.  Individual
  544.        elements (file names) in these lists are separated by commas.
  545.        File names may not have extensions (i.e., may not contain a
  546.        period) and full DOS path names may be used.  For example,
  547.        FILES>OUT1,OUT2=INPUT1,INPUT2,INPUT3  represents  lists  of  two
  548.        output files (OUT1 and OUT2) and three input files (INPUT1,
  549.        INPUT2, and INPUT3).  For programs that generate no output files,
  550.        the user only enters the list of input files.  If an input file
  551.        does not exist, the user is informed and requested to reenter the
  552.        FILES> line.  If an output file already exists, the user is asked
  553.        if this file should be over-written.  Prior to the FILES> prompt
  554.        the user is informed of the expected number of file names and the
  555.        maximum number of samples per line that is permitted.  All input
  556.        files must be of the same size (i.e., contain the same number of
  557.        lines and samples).
  558.  
  559.             The input of program parameters is given by the user at the
  560.        PARAM> prompt.  Prior to issuing the PARAM> prompt, the program
  561.        displays  the  valid  parameter  names,  their  default  values
  562.        (enclosed in brackets), and their meaning.  Parameters are
  563.        assigned values by entering their name, followed by the equal
  564.        sign, followed by a value.  Values may be numeric constants or
  565.        character  strings.    Character  strings  must  be  enclosed  in
  566.        apostrophes.  Some parameters are set by simply entering their
  567.        name (i.e., without the equal sign followed by a value).  An
  568.        example would be the specification of which type of computation
  569.        is desired.  Commas are used to separate the setting of multiple
  570.        parameters.  For example, the valid parameters for the LIST
  571.        program are SS, SL, ES, EL, LINC, SINC, PAGE, and HEAD.  If the
  572.        user entered the line SS=200, EL=200, PAGE, HEAD='1st 200'
  573.        he would be requesting a single page listing of the first 200
  574.        lines and samples with the title '1st 200'.
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.                                        7
  592.  
  593.  
  594.  
  595.  
  596.  
  597.                               PC-MIPS User Manual
  598.  
  599.  
  600.  
  601.                               PC-MIPS Programs
  602.  
  603.        CMBIMG
  604.  
  605.             This program is used to create an output file composed of
  606.        multiple images which can be viewed using the IMDISP program.
  607.        CMBIMG prompts for the input/output file specifications in normal
  608.        PC-MIPS form (i.e., OUTPUT=INPUT1,INPUT2,INPUT3,INPUT4).  There
  609.        may be from two to four input images and the size (number of
  610.        lines and samples) of all input images MUST be equal.
  611.  
  612.             The composite output image (i.e., file) is structured as
  613.        shown below:
  614.                           ------ ------
  615.                          |INPUT1|INPUT2|
  616.                  OUTPUT= |------|------|
  617.                          |INPUT3|INPUT4|
  618.                           ------ ------
  619.  
  620.        hint:
  621.        An output file of more than four input images can be created by
  622.        repeated use of CMBIMG.
  623.  
  624.        Example:
  625.  
  626.        CMBIMG  18-MAY-88                   # of files
  627.        bit types:   8                    2 - 4 input
  628.        max samples: 3000                   1   output
  629.  
  630.        File name where the processed results will be stored.
  631.          (e.g., OUTPUT
  632.        File name(s) that has (have) the input data to be processed.
  633.          =INPUT1,INPUT2,INPUT3)
  634.                 ------ ------
  635.                |INPUT1|INPUT2|
  636.        OUTPUT= |------|------|
  637.                |INPUT3|INPUT4|
  638.                 ------ ------
  639.  
  640.        FILES> comb=sample,m1,m2
  641.        FILES>
  642.        Do you want to display comb (y/n)? n
  643.  
  644.  
  645.        DERIV
  646.  
  647.             Program DERIV performs a derivative (or first difference)
  648.        function on an image.  The derivative can be in the horizontal,
  649.        vertical, or diagonal direction as specified by the user.  The
  650.        equations used are:
  651.  
  652.        horizontal - Y(i,j) = X(i,j) - X(i+1,j) + C
  653.        vertical   - Y(i,j) = X(i,j) - X(i,j+1) + C
  654.        diagonal   - Y(i,j) = X(i,j) - X(i+1,j+1) + C
  655.  
  656.  
  657.                                        8
  658.  
  659.  
  660.  
  661.  
  662.  
  663.                               PC-MIPS User Manual
  664.  
  665.  
  666.  
  667.  
  668.        where X is the input image, Y is the output image, and C is a
  669.        user-specified constant.
  670.  
  671.             The user enters the input/output file names at the FILES>
  672.        prompt.  The program then displays the four valid parameters and
  673.        issues a PARAM> prompt.  The desired direction is selected
  674.        entering one of the three directional parameters HORZ, VERT, or
  675.        DIAG.  The fourth parameter IADB is provided as an add-back
  676.        constant which defaults to 127 if not specified.
  677.  
  678.        Example:
  679.  
  680.        DERIVE  12-JAN-85                   # of files
  681.        bit types:   8                      1   input
  682.        max samples: 3000                   1   output
  683.  
  684.        Filename where the processed results will be stored.
  685.          (e.g., OUTPUT
  686.        Filename that has the input data to be processed.
  687.           =INPUT)
  688.        FILES> hdrev=sample
  689.  
  690.        Valid parameters are:
  691.        HORZ:[] - Performs a horizontal derivative
  692.        VERT:[] - Performs a vertical derivative
  693.        DIAG:[] - Performs a diagonal derivative
  694.        IADB:[127] - Addback constant
  695.          (e.g., HORZ,IADB=127)
  696.  
  697.        PARAM> horz, iadb=100
  698.        FILES>
  699.        Do you want to display hderv (y/n)? n
  700.  
  701.  
  702.        EDGENH
  703.  
  704.             EDGENH uses a Laplace transform to perform edge enhancement
  705.        on images.  The transform matrix is as follows:
  706.                    0  -1   0
  707.                   -1   4  -1
  708.                    0  -1   0
  709.             The user is prompted for input/output file names via the
  710.        FILES> prompt.  Next, the user is prompted to enter a value
  711.        representing the fraction of the Laplace transform to be added.
  712.        Each interior pixel Y(i,j) is calculated according to the formula
  713.        Y(i,j)=X(i,j)+f*[4*X(i,j)-X(i-1,j)-X(i,j-1)-X(i+1,j)-X(i,j+1)]
  714.        where X is the input image, Y is the output image and f is the
  715.        user-specified fraction.  Boundary pixels are unchanged.
  716.  
  717.        Example:
  718.  
  719.        EDGENH  18-JUNE-88                  # of files
  720.        bit types:   8                      1   input
  721.  
  722.  
  723.                                        9
  724.  
  725.  
  726.  
  727.  
  728.  
  729.                               PC-MIPS User Manual
  730.  
  731.  
  732.  
  733.        max samples: 3000                   1   output
  734.  
  735.        File name where the results are to be stored
  736.          (e.g., OUTPUT
  737.        File name where the input data is located
  738.          = INPUT)
  739.        FILES> edge = sample
  740.        Enter fraction of Laplace transform to be added: 0.4
  741.        FILES>
  742.        Do you want to display edge (y/n)?  n
  743.  
  744.  
  745.        EXT_ROI
  746.  
  747.             This program extracts sub-images from up to 7 input images.
  748.        The sub-image is specified by an ascii file named POLYGON.DAT
  749.        which contains the polygon vertices which define the sub-image.
  750.        The first record in this file contains the number of vertices.
  751.        Subsequent records contain the vertices themselves.  They are
  752.        given as sample/row pairs.  This file must be present in the
  753.        working directory when the program is executed.  Output and input
  754.        file names are given by the user at the FILES> prompt.
  755.  
  756.  
  757.        IMDISP
  758.  
  759.             Refer to IMDISP.DOC file for description.
  760.  
  761.  
  762.        LIST
  763.  
  764.             This program will generate a printout of DN values.  The
  765.        user can select a window by specifying starting/ending line and
  766.        sample numbers.  Additionally, line and sample increments may be
  767.        given.  If a single-page printout is requested, the program
  768.        automatically determines the line and sample increments which
  769.        will achieve this result.
  770.  
  771.             The name of the image to be listed is specified on the
  772.        FILES> prompt line.  The desired listing parameters are specified
  773.        on the PARAM> prompt line.  The parameters which may be specified
  774.        are as follows:
  775.  
  776.             SS:[1]   - Starting sample number
  777.             SL:[1]   - Starting line number
  778.             ES:[NS]  - Ending sample number
  779.             EL:[NL]  - Ending line number
  780.             SINC:[1] - Sample increment
  781.             LINC:[1] - Line increment
  782.             PAGE:[]  - List total area on one page
  783.             HEAD:[]  - Label to be put on top of printout
  784.  
  785.        Note  that  default  values  are  indicated  within  the square
  786.        brackets.  As an example, SS=10, LINC=5, HEAD='SAMPLE LISTING'
  787.  
  788.  
  789.                                        10
  790.  
  791.  
  792.  
  793.  
  794.  
  795.                               PC-MIPS User Manual
  796.  
  797.  
  798.  
  799.        would generate a listing of every fifth line and all samples
  800.        after the first nine.  The listing would be titled 'SAMPLE
  801.        LISTING'.
  802.  
  803.             The output file which contains the listed DN values is
  804.        named LIST.PRT.  Sample numbers are given along the top of pages
  805.        and line numbers are given down the first column of pages.  Each
  806.        page contains 50 lines and 25 samples.  Multiple pages are
  807.        generated until the entire specified area is represented.
  808.  
  809.        Example:
  810.  
  811.        LIST  9-AUG-84                      # of files
  812.        bit types:   8                      1   input
  813.        max samples: 8000                   0   output
  814.  
  815.        File name that has the input data to be processed.
  816.        FILES> sample
  817.        Valid parameters are:
  818.        SS:[1]   -Starting sample
  819.        SL:[1]   -Starting line
  820.        ES:[NS]  -Ending sample (defaults to the number of samples in the
  821.                  input file)
  822.        EL:[NL]  -Ending line (defaults to the number of lines in the
  823.                  input file)
  824.        LINC:[1] -Line increment
  825.        SINC:[1] -Sample increment
  826.        PAGE:[]  -List total area on one page.
  827.        HEAD:[]  -Label to be put on top of listing.
  828.  
  829.          (e.g., LINC=1,SINC=1,PAGE, HEAD='LABEL')
  830.  
  831.        PARAM> ss=151, es=200, sl=201, el=300, sinc=2
  832.        FILES>
  833.  
  834.  
  835.        MAPIMG
  836.  
  837.             MAPIMG provides the ability to create an output image which
  838.        is computed by a user-specified mapping of from 1 to 7 input
  839.        images.  The mapping is done on a pixel-by-pixel basis.
  840.  
  841.             The user first specifies the output and input image file
  842.        names in the normal PC-MIPS format (e.g.  out=in1,in2,in3).
  843.        Next, the user specifies the mapping by entering a mathematical
  844.        expression which defines the desired mapping.
  845.        This  expression  may  contain  numeric  constants,  arithmetic
  846.        operators (+, -, /, *, and **), input image identifiers F1 to
  847.        F7 which refer to the corresponding input images, and intrinsic
  848.        functions.  Parenthesis may be used to control the order of
  849.        evaluation.
  850.  
  851.            The intrinsic functions supported are as follows:
  852.  
  853.  
  854.  
  855.                                        11
  856.  
  857.  
  858.  
  859.  
  860.  
  861.                               PC-MIPS User Manual
  862.  
  863.  
  864.  
  865.         Function    Returns
  866.         --------    -------
  867.         abs()    Absolute value
  868.         sqrt()   Square root
  869.         log()    Base 10 logarithm
  870.         ten()    Power of 10
  871.         int()    Integer truncation
  872.         sin()    Trigonometric sine
  873.         cos()          ''      cosine
  874.         max()    Maximum pixel value
  875.         min()    Minimum pixel value
  876.         rand()   Pseudo-random value in the range 0.0 to 1.0
  877.  
  878.             All functions take a mathematical expression as an argument.
  879.        This argument is evaluated prior to evaluating the function.  For
  880.        the max(), min(), and mean() functions, the evaluated argument is
  881.        considered an integer which represents the number of input images
  882.        to be considered.  The sin() and cos() functions assume their
  883.        argument to represent degrees.  The rand() function assumes its
  884.        argument to be a non-zero seed (or starting value) to be used in
  885.        generating the random numbers.
  886.  
  887.        Example:
  888.  
  889.        MAPIMG  10-MAY-88                   # of files
  890.        bit types:   8                    1 - 7 input
  891.        max samples: 3000                   1   output
  892.  
  893.        File name where the processed results will be stored.
  894.          (e.g., OUTPUT
  895.        File name(s) that has (have) the input data to be processed.
  896.          =INPUT1,INPUT2,INPUT3)
  897.        FILES> map1 = sample, m1, m2
  898.        Enter mapping as a function of the input files F1 - F7
  899.           (i.e. 0.33*(F1+F2+F3) or (F1+F2)/F3+127  )
  900.        MAPPING> (f1 + 0.5*(max(3) - min(3)) + f2 + f3)/3
  901.        FILES>
  902.        Do you want to display map1 (y/n)? n
  903.  
  904.  
  905.        MAPLN1
  906.  
  907.             MAPLN1 enhances linear features using a semi-linear line
  908.        detecting/mapping technique.  The semi-linear technique is one
  909.        proposed by G. J. Vanderbrug (1975) and is a compromise between
  910.        linear and nonlinear detectors.  It makes separate comparisons to
  911.        the left and to the right so it does not respond to edges but
  912.        will respond to isolated noise.  For more information see Bureau
  913.        of Mines report on automatic linear feature mapping by Chavez
  914.        (1983).
  915.  
  916.             The only user input is the input/output file names at the
  917.        FILES> prompt.
  918.  
  919.  
  920.  
  921.                                        12
  922.  
  923.  
  924.  
  925.  
  926.  
  927.                               PC-MIPS User Manual
  928.  
  929.  
  930.  
  931.        Example:
  932.  
  933.        MAPLN1  24-JAN-85                   # of files
  934.        bit types:   8                      1   input
  935.        max samples: 3000                   1   output
  936.  
  937.        File name where the processed results will be stored.
  938.         (e.g., OUTPUT
  939.        File name that has the input data to be processed.
  940.          =INPUT)
  941.        FILES> linout = sample
  942.        FILES>
  943.        Do you want to display linout (y/n)? n
  944.  
  945.  
  946.        MDGRAD
  947.  
  948.             This program uses a modified gradient method for linear
  949.        feature  enhancement/mapping,  but  instead  of  multiplying  the
  950.        constants A, B, C, and D together they are added.  The reason for
  951.        this is that if only one of them is zero, no information is seen
  952.        and the computation is faster.
  953.  
  954.             The formulas used are:
  955.  
  956.        A = |X(i+2,j+1)-X(i+3,j+2)| + |X(i+2,j+2)-X(i+3,j+1)|
  957.        B = |X(i+1, j )-X(i+4,j+3)| + |X(i+1,j+3)-X(i+4, j )|
  958.        C = |X(i+2, j )-X(i+3,j+3)| + |X(i+1,j+2)-X(i+4,j+1)|
  959.        D = |X(i+3, j )-X(i+2,j+3)| + |X(i+1,j+1)-X(i+4,j+2)|
  960.        Y(i,j) = A + B + C + D
  961.        where X is the input image and Y is the output image.
  962.  
  963.             The only user input is the input/output file names at the
  964.        FILES> prompt.
  965.  
  966.        Example:
  967.  
  968.        MDGRAD  21-AUG-84                   # of files
  969.        bit types:   8                      1   input
  970.        max samples: 3000                   1   output
  971.        File name where the processed results will be stored.
  972.          (e.g., OUTPUT
  973.        File name that has the input data to be processed.
  974.          =INPUT)
  975.        FILES> mdout = sample
  976.        FILES>
  977.        Do you want to display mdout (y/n)?  n
  978.  
  979.  
  980.        MEDIAN
  981.  
  982.             This program applies a 3 x 3 median filter to an image.  It
  983.        will smooth the data in a slightly different manner than that
  984.        done by a simple average.  The median is equal to the middle item
  985.  
  986.  
  987.                                        13
  988.  
  989.  
  990.  
  991.  
  992.  
  993.                               PC-MIPS User Manual
  994.  
  995.  
  996.  
  997.        in a distribution which has been arranged by increasing value.
  998.        Therefore the median location is equal to the pixel in the exact
  999.        center and its DN value is assigned to the output pixel.
  1000.  
  1001.             Output and input file names are specified on the FILES>
  1002.        prompt line.  There are no other program parameters to be
  1003.        entered.
  1004.  
  1005.        Example:
  1006.  
  1007.        MEDIAN  31-MAY-85                   # of files
  1008.        bit types:   8                      1   input
  1009.        max samples: 3000                   1   output
  1010.  
  1011.        File name where the results are to be stored
  1012.          (e.g., OUTPUT
  1013.        File name where the input data is located
  1014.          = INPUT)
  1015.        FILES> m1=sample
  1016.        FILES>
  1017.        Do you want to display m1 (y/n)? n
  1018.  
  1019.  
  1020.        OVRLAY
  1021.  
  1022.             OVRLAY takes from 2 to 6 input images and generates one
  1023.        output image that indicates which of the input images have data
  1024.        in user specified ranges for the input images being used.
  1025.  
  1026.             This program can be used as part of an IMAGE or GIS
  1027.        processing system.  In the GIS mode it can be used to overlay and
  1028.        merge various data sets together and in the IMAGE processing mode
  1029.        as a quick parallelepiped classifier.  Currently there is a limit
  1030.        of six input files, but more can be processed by executing the
  1031.        program twice on two different groups of input files and then
  1032.        executing it a third time using the results of the first two
  1033.        groups as input.  But this will be good ONLY to map where the
  1034.        data is in given ranges for ALL the input files used.  The range
  1035.        of the third image results will be 0 to 3, where 3 indicates
  1036.        where the data is in the given ranges for all the files used.
  1037.        The program uses the MIN and MAX values for each input file
  1038.        supplied by the user to create a look-up table (ITBLA) indexed by
  1039.        the DN values of the input data.  The values assigned to ITBLA
  1040.        are either 1 or 2 (1 implies DN value outside range and 2 implies
  1041.        DN value inside MIN-MAX range).  This is like stretching all data
  1042.        outside the given range to 1 and inside the range to 2.
  1043.  
  1044.             The values (1 or 2) in this table (ITBLA) are then used to
  1045.        index into a second table (ITBLB) which has the correct sum or DN
  1046.        value for the given input file ranges.  The values in the second
  1047.        table (ITBLB) are computed as if the input files were summed
  1048.        after they were given the values of 0 and 1,2,4,8,16, or 32
  1049.        according to the data being outside (0) or inside (FILE1=1,
  1050.        FILE2=2, FILE3=4, FILE4=8, FILE5=16, and FILE6=32) the specified
  1051.  
  1052.  
  1053.                                        14
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.                               PC-MIPS User Manual
  1060.  
  1061.  
  1062.  
  1063.        ranges.  The data range of the output image will be from zero to
  1064.        (2**NFILES-1) where NFILES = number of input files used (2 to 6).
  1065.  
  1066.             In the case of four input files, the following table (where
  1067.        YES indicates value of given input file is in specified range)
  1068.        gives the value of the output file for possible combinations of
  1069.        input values:
  1070.  
  1071.        INPUT    INPUT    INPUT    INPUT    OUTPUT
  1072.        FILE1    FILE2    FILE3    FILE4      DN
  1073.        -----    -----    -----    -----    ------
  1074.          NO       NO       NO       NO        0
  1075.         YES       NO       NO       NO        1
  1076.          NO      YES       NO       NO        2
  1077.         YES      YES       NO       NO        3
  1078.          NO       NO      YES       NO        4
  1079.         YES       NO      YES       NO        5
  1080.          NO      YES      YES       NO        6
  1081.         YES      YES      YES       NO        7
  1082.          NO       NO       NO      YES        8
  1083.         YES       NO       NO      YES        9
  1084.          NO      YES       NO      YES       10
  1085.         YES      YES       NO      YES       11
  1086.          NO       NO      YES      YES       12
  1087.         YES       NO      YES      YES       13
  1088.          NO      YES      YES      YES       14
  1089.         YES      YES      YES      YES       15
  1090.  
  1091.        These values may be summarized as follows:
  1092.        0             =  All 4 files NO
  1093.        1,2,4,8       =  Only 1 file YES
  1094.        3,5,6,9,10,12 =  2 files YES
  1095.        7,11,13,14    =  3 files YES
  1096.        15            =  All 4 files YES
  1097.  
  1098.        Example:
  1099.  
  1100.        OVRLAY  3-MAY-84                    # of files
  1101.        bit types:   8                    2 - 6 input
  1102.        max samples: 3000                   1   output
  1103.  
  1104.        File name where the processed results will be stored.
  1105.         (e.g., OUTPUT
  1106.        File names that have the input data to be processed.
  1107.         =INPUT1,INPUT2,INPUT3)
  1108.        FILES> overlay = sample, bathy, dpth
  1109.  
  1110.        Valid parameters are:
  1111.        MIN* = Minimum value for FILE(1-6)
  1112.        MAX* = Maximum value for FILE(1-6)
  1113.           * .. Replace with the file number.
  1114.        There are no default values.
  1115.        Values for MIN* and MAX* must be between 0 and 255.
  1116.        (e.g., MIN1=5,MAX1=70,MIN2=22,MAX2=33,MIN3=0,MAX3=96)
  1117.  
  1118.  
  1119.                                        15
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.                               PC-MIPS User Manual
  1126.  
  1127.  
  1128.  
  1129.  
  1130.        PARAM> min1=3,max1=240, min2=5,max2=170, min3=10,max3=210
  1131.        FILES>
  1132.        Do you want to display overlay (y/n)? n
  1133.  
  1134.  
  1135.        RATIO
  1136.  
  1137.             This program is used to generate output images which are
  1138.        ratios of input images.  Up to four input images and three output
  1139.        images may be specified.
  1140.  
  1141.             The names of the output and input images are specified on
  1142.        the  FILES>  prompt  line.    The  program  then  requests  ratio
  1143.        parameters on the PARAMS> prompt line.  The parameters which may
  1144.        be specified are as follows:
  1145.  
  1146.             R1 - A two digit number specifying how the first output
  1147.                  image is to be calculated.  The first digit gives the
  1148.                  number of the input file which is to be used as the
  1149.                  numerator.  The second digit gives the number of the
  1150.                  input file which is to be used as the denominator.  For
  1151.                  example R1=13, specifies that the first output image is
  1152.                  the ratio of the first and third input images.
  1153.             R2 - Same as R1, but for the second output image.
  1154.             R3 - Same as R1, but for the third output image.
  1155.           FACT - A value which is to be used as a multiplication factor.
  1156.                  The default value is 1.
  1157.  
  1158.        Example:
  1159.  
  1160.        RATIO  28-SEP-83                    # of files
  1161.        bit types:   8                    2 - 4 input
  1162.        max samples: 3000                 1 - 3 output
  1163.        File names where the processed results will be stored (1-3
  1164.        images).
  1165.          (e.g., OUTPUT
  1166.        File names that have the input data to be processed (2-4 images).
  1167.         = INPUT1,INPUT2)
  1168.        FILES> band17,band24=band1,band2,band4,band7
  1169.  
  1170.        Valid parameters are:
  1171.        R1:[]     -First ratio
  1172.        R2:[]     -Second ratio
  1173.        R3:[]     -Third ratio
  1174.        FACT:[1.0]-Ratio multiplying factor
  1175.          (e.g.,R1=12,R2=13,FACT=1.2)
  1176.        R1=12 means that the 1'st ratio will be input file 1 divided by
  1177.           file 2
  1178.        R2=13 means that the 2'nd ratio will be input file 1 divided by
  1179.           file 3
  1180.        R3=23 means that the 3'rd ratio will be input file 2 divided by
  1181.           file 3
  1182.  
  1183.  
  1184.  
  1185.                                        16
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.                               PC-MIPS User Manual
  1192.  
  1193.  
  1194.  
  1195.        PARAM> r1=14, r2=23
  1196.        FILES>
  1197.        Do you want to display band17 (y/n)? n
  1198.  
  1199.  
  1200.        ROI
  1201.  
  1202.             This program requires VGA graphics capability and a serial
  1203.        MS-compatible mouse.  It allows the user to delineate a sub-image
  1204.        which is extracted from up to 7 input images.  The sub-image is
  1205.        determined by entering polygon vertices using a mouse.
  1206.  
  1207.             At the FILES> prompt the user enters output and input file
  1208.        names.  The first input file is displayed up to a maximum of 480
  1209.        lines and 640 samples.  Next, the user positions the graphics
  1210.        cursor (an arrow) to an initial vertex and "clicks" on that point
  1211.        by pressing the leftmost mouse button.  That point is illuminated
  1212.        and the user moves to the second vertex and "clicks" on it using
  1213.        the same button.  A line is drawn connecting the two points.  The
  1214.        remaining vertices, up to the last, are specified in the same
  1215.        manner.  When the cursor has been positioned on the last vertex,
  1216.        the polygon is closed by "clicking" with the second mouse button.
  1217.  
  1218.             After the polygon has been entered, the program creates the
  1219.        specified sub-image from each of the input files and creates an
  1220.        ascii file named POLYGON.DAT which contains the polygon vertices
  1221.        in a format acceptable to EXT_ROI which can be executed if sub-
  1222.        images from additional files are desired.
  1223.  
  1224.  
  1225.        ROTATE
  1226.  
  1227.             This program rotates an image 90 degrees (i.e., interchanges
  1228.        lines  and  samples)  in  the  clockwise  or  counter-clockwise
  1229.        direction.  The user specifies output and input file names on the
  1230.        FILES> prompt line.  The program, then, requests the direction of
  1231.        rotation.  Entering 0 (zero) indicates clockwise and 1 (one)
  1232.        indicates counter-clockwise.
  1233.  
  1234.             If the input image is small enough to reside in the
  1235.        available computer memory, the execution is very fast.  For
  1236.        larger images, each pixel must be accessed individually and the
  1237.        execution time is quite slow.  If this situation exists, a
  1238.        warning is given.
  1239.  
  1240.        Example:
  1241.  
  1242.        ROTATE  18-OCT-88                   # of files
  1243.        bit types:   8                      1   input
  1244.        max samples: 3000                   1   output
  1245.  
  1246.        File name where the results are to be stored
  1247.          (e.g., OUTPUT
  1248.        File name where the input data is located
  1249.  
  1250.  
  1251.                                        17
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.                               PC-MIPS User Manual
  1258.  
  1259.  
  1260.  
  1261.          = INPUT)
  1262.        FILES> r1=m1
  1263.        Enter 0 for clockwise or 1 for counter-clockwise: 0
  1264.        FILES>
  1265.        Do you want to display r1 (y/n)? n
  1266.  
  1267.  
  1268.        SALTP
  1269.  
  1270.             This program is used to remove bit errors from images.  The
  1271.        removal is based on a DN tolerance value which may be specified
  1272.        by the user or determined automatically based on the image
  1273.        histogram.
  1274.  
  1275.             A 3-line by 5-sample box is moved from left to right and
  1276.        from top to bottom through the input image to remove bad pixels
  1277.        from the image.  This box is illustrated below:
  1278.              ---- ---- ---- ---- ----
  1279.             | U1 | U2 | U3 | U4 | U5 |
  1280.              ---- ---- ---- ---- ----
  1281.             | M1 | M2 | M3 | M4 | M5 |
  1282.              ---- ---- ---- ---- ----
  1283.             | L1 | L2 | L3 | L4 | L5 |
  1284.              ---- ---- ---- ---- ----
  1285.        Each time the box is moved, the pixel element in the middle (M3)
  1286.        of the box is compared with averages of other pixels inside the
  1287.        box to determine if the pixel needs to be replaced.  This is done
  1288.        in two steps.  Step 1 finds the average of the two points at the
  1289.        upper left corner of the box (U1 and U2) and the average of the
  1290.        two points at the lower right hand corner of the box (L4 and L5).
  1291.        If the difference of the two averages is greater than four times
  1292.        the tolerance limit then the box is currently over an edge in the
  1293.        image. If the edge test succeeds (box is over an edge) then the
  1294.        pixel in the middle cannot be corrected.  If the edge test fails
  1295.        then step 2 is performed.  Step 2 finds the average of the line
  1296.        above (U1-U5) and the line below (L1-L5) the line containing the
  1297.        pixel to be corrected. If the difference of the point in the
  1298.        middle and the average is greater than the acceptable tolerance
  1299.        then the point is considered bad data and is replaced with the
  1300.        average of the box.
  1301.  
  1302.        Example:
  1303.  
  1304.        SALTP  21-DEC-84                    # of files
  1305.        bit types:   8                      1   input
  1306.        max samples: 3000                   1   output
  1307.  
  1308.        File name where the processed results will be stored.
  1309.          (e.g., OUTPUT
  1310.        File name that has the input data to be processed.
  1311.          =INPUT)
  1312.        FILES> cleaned = sample
  1313.  
  1314.        Valid parameters are:
  1315.  
  1316.  
  1317.                                        18
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.                               PC-MIPS User Manual
  1324.  
  1325.  
  1326.  
  1327.        TOL:[]  - Integer DN tolerance value to be used to identify
  1328.                  pixels that have a bit error. If not specified,
  1329.                  TOL is calculated based on the histogram.
  1330.        PARAM> tol = 11
  1331.        TOLERANCE= 11 Percentage of pixels changed =  25.8
  1332.        FILES>
  1333.        Do you want to display cleaned (y/n)?  n
  1334.  
  1335.  
  1336.        SHAD2
  1337.  
  1338.             SHAD2 computes the average of each sample position using
  1339.        every other line.  The computed averages are then normalized by
  1340.        either the average value of all the averages or by a user
  1341.        supplied DN value (e.g., NORM).  It can be used to correct for
  1342.        shading problems that exist in the horizontal direction (e.g., on
  1343.        sonar or radar data).
  1344.  
  1345.             SHAD2  uses  the  normalized  average  values  as  shading
  1346.        coefficients for image shading corrections.  The user specifies
  1347.        values of TOL1 and TOL2 which are used to compute the average
  1348.        values using only data greater than or equal to TOL1 and less
  1349.        than or equal to TOL2.  It passes through the input data twice,
  1350.        once to compute the correction coefficients and the second time
  1351.        to apply them.  The user may specify a beginning sample number
  1352.        (e.g., ISS) for the computation.
  1353.  
  1354.             The user-specified keywords are as follows:
  1355.  
  1356.        TOL1:[0]     - Lower DN limit tolerance to be used to compute
  1357.                       averages.
  1358.        TOL2:[maxdn] - High DN limit tolerance to be to compute averages.
  1359.        ISS:[1]      - Starting sample user wants to start processing the
  1360.                       input data.  Output lines will still contain all
  1361.                       samples.
  1362.        NORM:[ave]   - DN values to be used to normalize all the
  1363.                       averages.  Default is the average of all the
  1364.                       averages.
  1365.  
  1366.        Example:
  1367.  
  1368.        SHAD2  27-APR-84                    # of files
  1369.        bit types:   8                      1   input
  1370.        max samples: 3000                   1   output
  1371.  
  1372.        File name where the processed results will be stored.
  1373.          (e.g., OUTPUT
  1374.        File name that has input data to be processed.
  1375.          =INPUT)
  1376.        FILES> shaded = sample
  1377.  
  1378.        Valid parameters are:
  1379.        TOL1:[0]     - Lower DN tolerance to be used to compute averages.
  1380.        TOL2:[maxdn] - High DN tolerance to use to compute averages.
  1381.  
  1382.  
  1383.                                        19
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.                               PC-MIPS User Manual
  1390.  
  1391.  
  1392.  
  1393.        ISS:[1]      - Starting sample to start processing.
  1394.                       Output lines will still contain all samples.
  1395.        NORM:[ave]   - DN value to be used to normalize all the averages.
  1396.                       Default is average of averages.
  1397.           (e.g., TOL1=1,TOL2=250,ISS=17,NORM=100)
  1398.  
  1399.        PARAM> tol1=5, tol2=250, norm=100
  1400.        FILES>
  1401.        Do you want to display shaded (y/n)?  n
  1402.  
  1403.  
  1404.        STRTCH
  1405.  
  1406.             The STRTCH program performs contrast stretching on images.
  1407.        The user can specify up to ten stretch intervals.  A stretch
  1408.        interval is specified by four values.  These four values are
  1409.        given in terms of DN values.  They are IN_LOW, IN_HIGH, OUT_1,
  1410.        and OUT_2.  IN_LOW and IN_HIGH represent an input interval.
  1411.        OUT_1 and OUT_2 represent the corresponding output interval.
  1412.  
  1413.             Input DN values are assigned to values in the output
  1414.        interval based on their position within the input interval.  If
  1415.        IN_LOW is equal to IN_HIGH, input DN values of IN_LOW are
  1416.        assigned the value of OUT_1.  IN_HIGH cannot be less than IN_LOW.
  1417.        Input DN values not within any of the specified input intervals
  1418.        are unchanged.
  1419.  
  1420.             If OUT_1 is equal to OUT_2, all DN values in the input
  1421.        interval are reassigned a value of OUT_1.  If OUT_2 is less
  1422.        than OUT_1, an 'inverse' stretch is performed (i.e., increasing
  1423.        input DN values are reassigned to decreasing output DN values).
  1424.        Note:
  1425.             STRTCH differs from the MIPS STRETC program which uses
  1426.        stretch 'pairs' instead of stretch 'intervals' to specify the
  1427.        stretch operation.
  1428.  
  1429.        Example:
  1430.  
  1431.        STRETC  09-NOV-88                   # of files
  1432.        bit types:   8                      1   input
  1433.        max samples: 3000                   1   output
  1434.  
  1435.        File name where the processed results will be stored.
  1436.          (e.g., OUTPUT.EXT
  1437.        File name that has the input data to be processed.
  1438.           =INPUT.EXT)
  1439.        FILES> result = image
  1440.        Enter number of stretch intervals: 4
  1441.        Enter IN_LOW, IN_HIGH, OUT_1, OUT_2 for interval  1:
  1442.          0,  15,   0,   0
  1443.        Enter IN_LOW, IN_HIGH, OUT_1, OUT_2 for interval  2:
  1444.         16,  71,   0, 127
  1445.        Enter IN_LOW, IN_HIGH, OUT_1, OUT_2 for interval  3:
  1446.         72, 127, 128, 255
  1447.  
  1448.  
  1449.                                        20
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.                               PC-MIPS User Manual
  1456.  
  1457.  
  1458.  
  1459.        Enter IN_LOW, IN_HIGH, OUT_1, OUT_2 for interval  4:
  1460.        128, 255, 255, 255
  1461.        FILES>
  1462.        Do you want to display result (y/n)? n
  1463.  
  1464.  
  1465.        SUBIMG
  1466.  
  1467.             The sub-image program is used to extract a user-specified
  1468.        sub-image.  This program is similar to the MIPS DK2DK program.
  1469.        Additionally, the output image may be 'flipped' (or 'reversed')
  1470.        in the line and/or sample directions.
  1471.  
  1472.             The user is prompted for an input file name.  After the
  1473.        input file name is specified, the number of lines and samples in
  1474.        the input file are displayed and the user is prompted for
  1475.        starting/ending line and sample numbers.  The output file is
  1476.        'flipped' by specifying an ending value less than the starting
  1477.        value.  Finally, the user is prompted for an output file name.
  1478.  
  1479.        Example:
  1480.  
  1481.        SUBIMG (10/88) allows the extraction and/or "flipping" of sub-
  1482.        images. The dimensions of the sub-image are entered by the user.
  1483.        "flipping" is accomplished by indicating starting values greater
  1484.        than ending values.
  1485.  
  1486.        Enter input file name:  study
  1487.        study contains        1112 lines and         984 samples
  1488.        Enter starting and ending line numbers:  1, 420
  1489.        Enter starting and ending sample numbers:  981, 400
  1490.        Enter output file name: sub_stdy
  1491.  
  1492.        Enter input file name:
  1493.  
  1494.  
  1495.        WTCMBO
  1496.  
  1497.             This program is used to generate an output image which is
  1498.        the weighted sum (i.e., a linear combination) of up to four input
  1499.        images.  The output is calculated using the following formula:
  1500.             Y = C1*X1 + C2*X2 + C3*X3 + C4*X4 +C5
  1501.             where
  1502.                  Y is the output image,
  1503.                  C1-C5 are user-specified constants, and
  1504.                  X1-X4 are user-specified input images.
  1505.        The computation is done using 16-bit arithmetic.
  1506.  
  1507.        Example:
  1508.  
  1509.        WTCMBO  04-JUN-84                   # of files
  1510.        bit types:   8                    1 - 4 input
  1511.        max samples: 3000                   1   output
  1512.  
  1513.  
  1514.  
  1515.                                        21
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.                               PC-MIPS User Manual
  1522.  
  1523.  
  1524.  
  1525.        File name where the processed results will be stored.
  1526.          (e.g., OUTPUT
  1527.        File name(s) that has (have) the input data to be processed.
  1528.          =INPUT1,INPUT2,INPUT3)
  1529.        FILES> sum = sample, shade
  1530.        Valid parameters are:
  1531.        CON1:[.25] - Weighting coefficient for input file 1.
  1532.        CON2:[.25] - Weighting coefficient for input file 2.
  1533.        CON3:[.25] - Weighting coefficient for input file 3.
  1534.        CON4:[.25] - Weighting coefficient for input file 4.
  1535.        CON5:[0]   - Add-back constant for output file.  Used to center
  1536.                     the results in 8-bit positive range.
  1537.           (e.g., CON1=1.0,CON2=-1.0,CON3=.5,CON5=100)
  1538.  
  1539.        PARAM> con1=0.75, con2=1.25, con5 = -127
  1540.        FILES>
  1541.        Do you want to display sum (y/n)? n
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.                                        22
  1582.  
  1583.  
  1584.  
  1585.